home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 July / EnigmA AMIGA RUN 09 (1996)(G.R. Edizioni)(IT)[!][issue 1996-07 & 08][EARSAN CD VIII].iso / earcd / comm2 / npns.lha / NPNS / NewPostNewsSpool.doc next >
Text File  |  1996-05-29  |  9KB  |  329 lines
  1.  
  2.  
  3.  
  4.          New Post News Spool 5.5 
  5.  
  6.          Nick d'Alterio - May 1996 
  7.  
  8.  
  9.     « Introduction         »   
  10.     « Installation         »
  11.     « Updating             »
  12.     « Online check         »
  13.     « sendnews             »
  14.     « postnews             »
  15.     « History              »
  16.     « Bugs                 »
  17.     « Conditions of Use    »
  18.     « Future Plans         »
  19.     « Thanks               »
  20.     « The Author           »
  21.  
  22.  
  23.  
  24.  
  25.          Introduction 
  26.  
  27. This pair of programs provide a method of spooling news so that you 
  28. can write your articles while offline and then send them off once
  29. you go online.
  30.  
  31. The original version was based on PostNewsSpool by James Burton, but
  32. this has long been left behind in terms of features. The latest version
  33. now no longer requires an external posting agent.
  34.  
  35.                         AmiTCP only
  36.  
  37.  
  38.  
  39.  
  40.          Installation 
  41.  
  42.  
  43. Copy sendnews and postnews to somewhere on your path and set the 
  44. appropriate environment variables described below.
  45.  
  46. postnews should be the program that is called by your news reading
  47. program to post the news. This will spool the article so that you 
  48. can use sendnews to send it off when you go online.
  49.  
  50.  
  51.  
  52.  
  53.                 Updating From Previous Versions 
  54.  
  55.  
  56. Updates from 5.2 to 5.5 :-
  57.  
  58.     Read the docs since both sendnews and postnews have new arguments
  59.  
  60. Updates from 4.x to 5.2 :-
  61.  
  62.     1. sendnews now posts news to the nntp server itself so the env 
  63.           variable PNS_POSTNEWS now has no use. If your news server 
  64.        requires authorisation DO NOT use the latest version. 
  65.        Authorisation is not supported - at least until someone tells 
  66.            me the procedure for authorisation.
  67.  
  68.         2. Env var PNS_OFFLINE has been changed to NNTPALWAYSQUEUE in line
  69.            with SMTPPost.
  70.  
  71.         3. Option -n has been changed to -Q same reason as above.
  72.  
  73.         4. If using Inet225 DO NOT upgrade. If there is enough demand I will
  74.            create a version for this stack.
  75.  
  76. Updates from 3.c to 4.x :-
  77.  
  78.     1. postnews argument -from has now changed to -f.
  79.  
  80. Updates from 1.x, 2.x to 3.x :-
  81.  
  82.     1. From version 3 sendnews will attempt to send any article
  83.        in the spooldir no matter what the name is. So if your news 
  84.            reader produces a fully formed news article with header you 
  85.            can drop it straight into the spooldir without using postnews.
  86.  
  87.     2. You should remove the seq file if you had it in your spooldir 
  88.            and the env variable PNS_SEQFILE
  89.  
  90.  
  91.  
  92.  
  93.                 Online Check 
  94.  
  95.  
  96. Since version 4.2 npns uses an environment variable ONLINE to determine
  97. if the machine is online or not. If this variable is set to 0 then 
  98. you are assumed to be offline anything else indicates you are online.
  99.  
  100. If this variable does not exist then both postnews and sendnews assume
  101. that you are offline.
  102.  
  103. This variable should be setup in the startnet and stopnet scripts for
  104. best use.
  105.  
  106. NOTE: Since 5.5 this is not used at all but it is probably a good idea
  107.       to keep for online detection by scripts.
  108.  
  109.  
  110.  
  111.  
  112.                 sendnews 
  113.  
  114.  
  115. sendnews now accepts arguments in the standard Amiga readargs format.
  116.  
  117. Usage:         sendnews ALL/S,HELP/S,A=ARTICLES/M
  118.         sendnews
  119.  
  120. If sendnews is run without arguments then it will behave the same as
  121. in previous versions and send all articles in the spool directory to
  122. the news server.
  123.  
  124. A=ARTICLES/M    Following this option should be a list of article 
  125.         filenames that you want posted to the server. If this
  126.         option is used the spooled articles will not be sent 
  127.         unless the ALL option is used
  128.  
  129. ALL/S        If this switch is used then both the articles in the
  130.         spool directory and those specified on the command line
  131.         will be sent.
  132.  
  133. HELP/S        Print a small amount of usage information after which
  134.         the spooled articles will be sent.
  135.  
  136. sendnews will send off the articles to the news server if online. If
  137. the posting fails for any reason the failed article will be appended 
  138. to the end of the failed archive indicated by PNS_FAILED_ARC 
  139. ( AmiTCP:Usr/Spool/sendnews.failed by default ). Each file in the
  140. failed archive will be separated by a line containing the date and time
  141. sendnews failed to post the article. 
  142.  
  143. sendnews requires that the environment variable NNTPSERVER is set so
  144. to be able to post the article.
  145.  
  146. Usage Examples
  147.  
  148.     sendnews            Sends spooled articles
  149.     sendnews ARTICLES file1 file2    Sends file1 and file2
  150.     sendnews ARTICLES file1    ALL    Sends spooled articles and file1
  151.  
  152.  
  153.  
  154.  
  155.                 postnews 
  156.  
  157.  
  158. This spools a news article ready for posting when online. The article 
  159. can be complete with header (as prepared by tin) or in its component 
  160. parts, in which case postnews puts them together so that the article 
  161. is ready for posting (Grn style).
  162.  
  163. It places the article in the spool directory PNS_SPOOLDIR 
  164. (AmiTCP:Usr/Spool/News by default).  The spooled filename has the 
  165. format msg.######### where ###### is a number which refers to the time 
  166. of writing.
  167.  
  168. If online at the time of writing the article then postnews immediately
  169. executes sendnews (which must be on the path) to send off the article.
  170. To stop postnews from sending the article create an environment variable
  171. called NNTPALWAYSQUEUE. This feature has been removed in 5.5 it may 
  172. return if there is anyone really wants it.
  173.  
  174. postnews now uses the standard amiga readargs command line arguments.
  175.  
  176. Usage:        postnews FROM/K,HELP/S,DEL/S,HEAD/K,BODY/K
  177.         postnews FROM/K,DEL/S,HEAD/K < article
  178.         postnews
  179.  
  180. If postnews is run with no arguments it expects the fully formed article
  181. to be input via stdin.
  182.  
  183. FROM/K        Add a line to header specifying the sender
  184.  
  185. HELP/S        Print some help then exits
  186.  
  187. HEAD/K        Get the article header from the file specified. If this
  188.         option is not used the entire article including header
  189.         should be in file BODY/K or on stdin
  190.  
  191. BODY/K        Read body of article from this file or complete article if
  192.         HEAD/K option is not used
  193.  
  194. DEL/S        Delete HEAD/K and BODY/K files if posting was successful.
  195.         Otherwise leave them untouched.
  196.  
  197.  
  198. If BODY/K option is not used, postnews expects to read the body from stdin.
  199.  
  200. Usage Examples
  201.  
  202.     postnews BODY article           Spools fully formed article 
  203.  
  204.     postnews < article           Spools fully formed article from stdin
  205.  
  206.     postnews BODY article DEL       Spools article then deletes original
  207.  
  208.     postnews BODY bod HEADheader       Spools article made from header and body
  209.  
  210.         postnews BODY bod HEAD header DEL  As above but deletes the original files
  211.  
  212.  
  213. e.g. For tin I use
  214.  
  215. set TIN_POST amitcp:bin/postnews FROM "nagd@oc.ic.ac.uk (Nicholas d'Alterio)" BODY %s
  216.  
  217. for Grn try
  218.  
  219.    amitcp:bin/postnews BODY .article  HEAD .header DEL
  220.  
  221.  
  222.     
  223.  
  224.  
  225.                 History 
  226.  
  227. 5.5   - sendnews now has command line options
  228.       - postnews command line now uses readargs
  229.       - Now uses only ADOS functions
  230.       - Compiled with no startup to make 300% smaller
  231.       - postnews does not call sendnews anymore
  232.       - Removed various bugs in sendnews
  233. 5.1   - Now posts news to server itself (AmiTCP only)
  234.       - PNS_NNTPPOST removed (redundant)
  235.       - PNS_OFFLINE changed to NNTPALWAYSQUEUE
  236.       - option -n changed to -Q
  237.       - Split up into separate source files
  238.       - Minor bugfixes, optimizations
  239.       - Made amigaguide documentation
  240. 4.2   - Various bugs in online check (schlonz@antilon.ame.osn.de)
  241.     Online check system redesigned, should work for any system now.
  242.       - Remove -a option. No longer had any purpose.
  243.       - Doesn't bother with DOS library opening anymore (let SAS handle this)
  244.       - sendnews can now appear anywhere on the path instead of amitcp:bin
  245. 4.1   - Postnews - New command line options -R, -x (for Grn users), -a
  246.       - Postnews - Changed check for onlineness
  247.       - Postnews - Improved command line checks
  248. 3.2   - New environment variable PNS_OFFLINE
  249. 3.1   - Now uses ADOS functions
  250.       - seq file no longer needed
  251.       - ANY file in the spooldir will be sent
  252.       - the failed archive entries are separated by a line
  253.     containing the time the file failed.
  254.       - new env variable PNS_NNTPPOST allows user to specify
  255.     program to post news
  256. 2.1   - Added support for environment variables
  257. 1.x   - Internal test versions
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                 Bugs 
  264.  
  265.  
  266. There are currently no known bugs.
  267.  
  268.  
  269.  
  270.  
  271.                 Conditions of Use 
  272.  
  273.  
  274.  
  275. Use it how you like just remember I accept NO liability for
  276. ANYTHING that happens.
  277.  
  278. Let me know of what you think of it, bugs, etc
  279.  
  280.  
  281.  
  282.  
  283.  
  284.                 Future Plans 
  285.  
  286.     - Improve networking code
  287.     - Improve user interface, add more options/control
  288.     - Maybe link with SpoolWatch
  289.  
  290. Give me some suggestions for other stuff
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                 Thanks 
  297.  
  298.  
  299. Thanks to James Burton for the original idea and code.
  300.           Jeroen T Vermeulen for some new ideas.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.          Me - Nick d'Alterio 
  307.  
  308.  
  309. I have just completed a Physics degree at Imperial College, London and I 
  310. currently studying for a MSc Computer Science.
  311.  
  312. I have several other programs on Aminet:-
  313.  
  314.     SpoolWatch -    Mail/News Spool monitor comm/net
  315.         nnn       -    Back propagation Neural Network misc/sci
  316.     complex    -    Complex number functions in C dev/c
  317.     matrix     -    Matrix functions in C dev/c
  318.  
  319. E-Mail
  320.  
  321.     nagd@oc.ic.ac.uk
  322.  
  323.  
  324.  
  325. ------------------------------------------------------------------------------------
  326. Nick d'Alterio (nagd@oc.ic.ac.uk)
  327.  
  328. $Id: NewPostNewsSpool.doc 1.9 1996/05/29 20:26:02 nagd Exp $
  329.